//----------------------------------------------------------------------------------------------//
//												//
//	Какого типа эта программа?								//
//												//
//----------------------------------------------------------------------------------------------//

Данная программа относится к типу индикаторов с обучаемым ИИ.
Встроенный ИИ обучаем, т. е. без предварительного обучения он не имеет
никаких параметров и просто не запустится.
Если вы получили ограниченную демо-версию не через магазин MQL5.com, то после скачивания
вручную поместите файл в папку «Indicators» терминала.


//----------------------------------------------------------------------------------------------//
//												//
//	Для чего это нужно?									//
//												//
//----------------------------------------------------------------------------------------------//

Этот индикатор использует обучаемый ИИ для прогнозирования будущего поведения цены:

- на 10 дней вперед,
- на 1.7 дня вперед,
- на 5 часов вперед,
- на 50 минут вперед,
- на 10 минут вперед.

Также здесь предусмотрены дополнительные сведения в виде:
- прогнозируемого отклонения цены в пунктах и,
- прогнозируемая ошибка в процентах (в случае если это значение превышает 50% то
программа выдаст предупреждение).

В этой программе встроен обучаемый ИИ, то есть перед использованием его
необходимо обучить на новых входных данных.


//----------------------------------------------------------------------------------------------//
//												//
//	Как получить файл входных данных для обучения соответствующих нейронных сетей?		//
//												//
//----------------------------------------------------------------------------------------------//

Как это сделать, описано в соответствующей инструкции с использованием «AI Learn Utility».
Утилита обучения AI бесплатна и может быть загружена вами вручную с
главной страницы продукта на сайте MQL5.


//----------------------------------------------------------------------------------------------//
//												//
//	Описание опций меню этой программы.							//
//												//
//----------------------------------------------------------------------------------------------//

Здесь представлены всего два параметра:

- 1) "Show Comment" - включает/выключает показ комментария в окне где запущена эта программа.
Это нужно если вы планируете использовать этот индикатор в Вашй программе MQL5 и тогда,
при необходимости, этот параметр можно выключить.
- 2) "Deviation" - включает/выключает показ прогнозируемого отклонения прогнозируемого значения
выраженного в пунктах.


//----------------------------------------------------------------------------------------------//
//												//
//	Тестирование демонстрационной версии этой программы.					//
//												//
//----------------------------------------------------------------------------------------------//

Перед началом тестирования необходимо обучить встроенный ИИ если этого не сделано ранее.
Бесплатная демонстрационная версия этой программы работающая только в тестере стратегий ограничена
таким образом что комментарий прогнозируемых значений будет отображатся только до
начала августа 2025 года, поэтому для бесплатного тестирования используйте временной диапазон
до этой даты.
Здесь лучше использовать режим тестирования - "OHLC на M1" для ускорения так как индикатор
рассчитывает свои новые значения только в момент открытия новых свечей.


//----------------------------------------------------------------------------------------------//
//												//
//	Использование этого индикатора в Вашей MQL5 программе.					//
//												//
//----------------------------------------------------------------------------------------------//

Этот индикатор имеет 3 буфера значений которые можно использовать:

a) "0 Буфер" - содержит информацию о спрогнозированной цене где есть всего 5 значений:

	0) - на 10 дней вперед,
	1) - на 1.7 дня вперед,
	2) - на 5 часов вперед,
	3) - на 50 минут вперед,
	4) - на 10 минут вперед.

b) "1 Буфер" - содержит информацию о спрогнозированном отклонениии
в виде - (отклонение в пунктах)*(значение одного пункта цены),
где есть всего 5 значений:

	0) - на 10 дней вперед,
	1) - на 1.7 дня вперед,
	2) - на 5 часов вперед,
	3) - на 50 минут вперед,
	4) - на 10 минут вперед.

c) "2 Буфер" - содержит информацию о спрогнозированной ошибке
в виде - (ошибка в процентах)/100 то есть значения от 0 до 1,
где есть всего 5 значений:

	0) - на 10 дней вперед,
	1) - на 1.7 дня вперед,
	2) - на 5 часов вперед,
	3) - на 50 минут вперед,
	4) - на 10 минут вперед.


//----------------------------------------------------------------------------------------------//
//												//
//	Особенности использования этой программы.						//
//												//
//----------------------------------------------------------------------------------------------//

Несмотря на то, что обучающая утилита "AI Learn Utility" использует OpenCL и требует наличия
соответствующего устройства, сама отдельная программа индикатора выполняет все вычисления на CPU и
не нуждается в поддержке OpenCL.

Минимальные требования к оборудованию:

- 20 гигабайт свободного места на жестком диске,
- 4 гигабайта видеокарта с поддержкой OpenCL,
- 16 гигабайт оперативной памяти.

ВНИМАНИЕ: - Файлы параметров ИИ для каждого символа занимают примерно 1 гигабайт.

Эта программа использует множество файлов с параметрами нейронной сети из
папки "//Common//Files//SolarTradeSuite//Theia//...", поэтому, вероятно, есть ограничения по
работе в тестере стратегий и на VPS.

Тестирование стратегий и оптимизация с этим индикатором, возможно, могут выполняться только локально или
невозможно использовать кластер агентов в локальной сети или
невозможно использовать облачную сеть MQL5.

Тестирование стратегий и оптимизация советников, а также
количество одновременно запущенных программ вне тестера стратегий также,
возможно, ограничено количеством одновременно открытых файлов, что примерно равно
160 локальным агентам и подробно описано в технической документации MQL5.

Те же ограничения для VPS: Данный индикатор не тестировался на возможность работы в
VPS, из-за большого количества файлов с параметрами AI, возможно, это не сработает.

Перед запуском убедитесь, что не менее 108 свечей таймфрейма «MN1» или 10 лет доступны с момента
запуска этой программы. Это необходимо, поскольку встроенный ИИ использует
историю цен за последние 9 лет в качестве входных данных для составления прогноза.

Вне тестера стратегий эта программа может быть запущена на любом таймфрейме, т. е.
таймфрейм окна, в котором запущена программа вне тестера стратегий, не имеет значения.

При первом запуске на ранее неиспользуемом символе необходимо сначала обучить ИИ -
как это сделать описано в соответствующей инструкции с использованием "AI Learn Utility".
Рекомендуется использовать "AI Learn Utility" как можно чаще, но
примерно не позднее одного-двух лет после последнего использования или
если с момента последнего обучения прошел большой промежуток времени,
или вы наблюдаете существенные изменения в поведении цены используемого символа.

Имейте в виду: "!!! ВНИМАНИЕ: Этот ИИ может ошибаться - обязательно проверяйте его прогнозы на корректность!!!".
Расчет ошибки и сам прогноз производятся с использованием методов передового математического,
статистического анализа и машинного обучения, но на цену финансового инструмента могут влиять
другие события, не учитываемые такими методами, такие как политические намерения, экологические события, погодные условия и т. д.

Все параметры ИИ сохраняются на жесткий диск в папку терминала "//Common//Files//SolarTradeSuite//Theia//... ".
Если у вас есть ссылка на скачивание готовых параметров для ИИ, то после скачивания скопируйте их туда.

Не забудьте вручную сделать резервную копию параметров ИИ в отдельную папку, которую вы создали сами.


//----------------------------------------------------------------------------------------------//
//												//
//	Дополнительные вопросы.									//
//												//
//----------------------------------------------------------------------------------------------//

Утилита обучения ИИ бесплатна и может быть загружена вами вручную с
главной страницы продукта на сайте MQL5.
Все инструкции доступны и могут быть загружены вами вручную с
главной страницы продукта на сайте MQL5. Пожалуйста, внимательно прочитайте все инструкции и
файл лицензии, прежде чем задавать какие-либо вопросы.

1) Пожалуйста, не стесняйтесь задавать вопросы во вкладке обсуждения на соответствующей странице индикатора на сайте MQL5.com.

2) Email для связи: gerasimovadam@gmail.com , tgwls2@gmail.com .